array-back

What is array-back?

The array-back npm package is designed to ensure that any value provided to it is returned as an array. This can be useful when you are not sure if a function will receive an argument as a single value or an array of values. It helps to normalize the input for further processing.

What are array-back's main functionalities?

Convert a non-array value to an array

This feature takes a single value and wraps it in an array. If the value is already an array, it returns the array unchanged.

[].concat(arrayBack(value))

Flatten nested arrays

This feature can be used to flatten nested arrays into a single-level array.

arrayBack([1, [2, [3]]])

Ignore empty slots in sparse arrays

This feature allows the conversion of sparse arrays into compact arrays without empty slots.

arrayBack(new Array(5))

Other packages similar to array-back

lodash

Lodash is a comprehensive utility library that provides a wide range of functions for working with arrays, objects, strings, etc. It includes methods like _.toArray which can convert values to arrays, similar to array-back, but it also offers a much larger set of utilities for different purposes.

arrify

Arrify is a minimalistic package that converts a non-array value into an array. It is similar to array-back in its basic functionality but does not offer additional features like flattening nested arrays or handling sparse arrays.

README

array-back

Takes any input and guarantees an array back.

• Converts array-like objects (e.g. arguments, Set) to a real array.
• Converts undefined to an empty array.
• Converts any another other, singular value (including null, objects and iterables other than Set) into an array containing that value.
• Ignores input which is already an array.

Example

> const arrayify = require('array-back')

> arrayify(undefined)
[]

> arrayify(null)
[ null ]

> arrayify(0)
[ 0 ]

> arrayify([ 1, 2 ])
[ 1, 2 ]

> arrayify(new Set([ 1, 2 ]))
[ 1, 2 ]

> function f(){ return arrayify(arguments); }
> f(1,2,3)
[ 1, 2, 3 ]

arrayify(input) ⇒ Array ⏏

Kind: Exported function

Param	Type	Description
input	*	The input value to convert to an array

Load anywhere

This library is compatible with Node.js, the Web and any style of module loader. It can be loaded anywhere, natively without transpilation.

Node.js:

const arrayify = require('array-back')

Within Node.js with ECMAScript Module support enabled:

import arrayify from 'array-back'

Within an modern browser ECMAScript Module:

import arrayify from './node_modules/array-back/index.mjs'

Old browser (adds window.arrayBack):

<script nomodule src="./node_modules/array-back/dist/index.js"></script>

---

© 2015-19 Lloyd Brookes <[e-mail]>. Documented by jsdoc-to-markdown.